home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 22 / PC Actual CD 22.iso / linux / xfree86 / DOC / README.ATI < prev    next >
Encoding:
Text File  |  1998-01-07  |  13.6 KB  |  529 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                   ATI adapters README
  11.  
  12.                  Marc Aurele La France
  13.  
  14.                  23 March 1996
  15.  
  16.  
  17.  
  18.                    Abstract
  19.  
  20.      This is the README for the XFree86 ATI VGA driver used in the
  21.      XF86_Mono, XF86_VGA16 and XF86_SVGA servers.  Users of ATI adapters
  22.      based on the Mach8, Mach32 or Mach64 (including 3D Rage and 3D Rage
  23.      II) accelerators should be using the accelerated servers (XF86_Mach8,
  24.      XF86_Mach32 or XF86_Mach64).  The unaccelerated servers (XF86_Mono,
  25.      XF86_VGA16 and XF86_SVGA) should still work, but are a waste of capa-
  26.      bilities.
  27.  
  28.  
  29.  
  30. 1.  What is the ATI VGA driver?
  31.  
  32. The ATI VGA driver is a 256-colour, 16-colour and monochrome driver for
  33. XFree86.  The driver is intended for all ATI video adapters except those that
  34. do not provide SuperVGA functionality (such as some early Mach8 and Mach32
  35. adapters).  The following approximate maximum resolutions (based on the Golden
  36. Ratio of x/y = (1 + sqrt(5))/2) are possible depending on the video memory
  37. available on the adapter (and the capabilities of your monitor):
  38.  
  39.      256k     640x409x256    896x585x16
  40.      512k     896x585x256   1280x819x16
  41.      1M    1280x819x256  1824x1149x16
  42.  
  43.  
  44. Maximum monochrome resolutions are the same as those for 16-colour mode,
  45. because the monochrome server uses a maximum of one fourth of the available
  46. video memory.
  47.  
  48.  
  49. 2.  What is the ATI VGA driver *not*?
  50.  
  51. This driver does not yet support more than 8 bits of pixel depth.  Even if your
  52. manual says that your graphics adapter supports modes using more than 256
  53. colours, the ATI VGA driver will not use these modes.
  54.  
  55. The ATI VGA driver is not an accelerated driver.  If your adapter is based on
  56. the Mach8, Mach32 or Mach64 video controllers, this driver will not use the
  57. accelerated functions of the hardware.    It will only use the VGA hardware
  58. (which, for Mach32's and Mach64's, is integrated into the accelerator).  This
  59. can make opaque moves, for example, quite jerky.
  60.  
  61.  
  62.  
  63.  
  64. ATI adapters README
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ATI adapters README
  71.  
  72.  
  73.  
  74. 3.  What video adapters will the driver work with?
  75.  
  76. Most adapters harbouring the following ATI video controller chips will work
  77. with this driver:
  78.  
  79.      VGA Wonder series:  18800, 18800-1, 28800-2, 28800-4, 28800-5, 28800-6
  80.      Mach32 series:  68800-3, 68800-6, 68800AX, 68800LX
  81.      Mach64 series:  88800GX-C, 88800GX-D, 88800GX-E, 88800GX-F, 88800CX,
  82.              264CT, 264ET, 264VT, 264VT2, 264GT
  83.  
  84.  
  85. The 264xT series are integrated controllers, meaning that they include an
  86. internal RAMDAC and clock generator.  Some early Mach32 adapters will not work
  87. with this driver because they do not provide VGA functionality.  Also, early
  88. Mach8 adapters will not work for the same reason, unless the adapter also has a
  89. video controller from the VGA Wonder series (or is connected to one through the
  90. VGA passthrough connector).
  91.  
  92. These adapters are available with a variety of clock generators and RAMDACs.
  93. See the XF86Config section below for details.  These adapters are available
  94. with or without a mouse.
  95.  
  96. VGA Wonder V3 adapters use a 18800 video controller and generate dot clocks
  97. with crystals.    VGA Wonder V4 adapters have a 18800-1 and also use crystals.
  98. VGA Wonder V5 adapters also use a 18800-1, but have a 18810 clock generator.
  99. VGA Wonder+ adapters use a 28800-2 and a 18810.  Other than these, ATI's
  100. adapter naming convention (if it can be said that one exists) starts to fall
  101. apart.
  102.  
  103. The VGA Wonder series was also available through ATI's OEM channel under the
  104. name VGA1024.  Thus, the ATI VGA driver also supports VGA1024, VGA1024D,
  105. VGA1024XL, VGA1024DXL and VGA1024VLB adapters, among others.
  106.  
  107.  
  108. 4.  What should I put in my XF86Config file?
  109.  
  110. The chipset will be automatically detected.  The chipset name for this driver
  111. is "ati".  The driver also recognizes "vgawonder", "mach8", "mach32" and
  112. "mach64" as chipset names.  In this version of the driver, all names are equiv-
  113. alent.    In some future version each name will have a different meaning to be
  114. documented at that time.
  115.  
  116. The clocks line to be specified in your XF86Config depends on what the adapter
  117. uses to generate dot clocks.
  118.  
  119. For all adapters, one of the following clocks specifications (or an initial
  120. subset thereof) can be used depending on what the adapter uses to generate dot
  121. clocks:
  122.  
  123.      Crystals (VGA Wonder V3 and V4 adapters only):
  124.  
  125.        Clocks  50.000  56.644    0.000  44.900  44.900  50.000    0.000  36.000
  126.            25.000  28.322    0.000  22.450  22.450  25.000    0.000  18.000
  127.            16.667  18.881    0.000  14.967  14.967  16.667    0.000  12.000
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ATI adapters README
  137.  
  138.  
  139.  
  140.            12.500  14.161    0.000  11.225  11.225  12.500    0.000    9.000
  141.  
  142.  
  143.  
  144.      ATI 18810 clock generator:
  145.  
  146.        Clocks  30.240  32.000  37.500  39.000  42.954  48.771    0.000  36.000
  147.            40.000  56.644  75.000  65.000  50.350  56.640    0.000  44.900
  148.            15.120  16.000  18.750  19.500  21.477  24.386    0.000  18.000
  149.            20.000  28.322  37.500  32.500  25.175  28.320    0.000  22.450
  150.            10.080  10.667  12.500  13.000  14.318  16.257    0.000  12.000
  151.            13.333  18.881  25.000  21.667  16.783  18.880    0.000  14.967
  152.         7.560    8.000    9.375    9.750  10.739  12.193    0.000    9.000
  153.            10.000  14.161  18.750  16.250  12.586  14.160    0.000  11.225
  154.  
  155.  
  156.  
  157.      ATI 18811-0 and ATI 18812-0 clock generators:
  158.  
  159.        Clocks  30.240  32.000 110.000  80.000  42.954  48.771  92.400  36.000
  160.            39.910  44.900  75.000  65.000  50.350  56.640    0.000  44.900
  161.            15.120  16.000  55.000  40.000  21.477  24.386  46.200  18.000
  162.            19.955  22.450  37.500  32.500  25.175  28.320    0.000  22.450
  163.            10.080  10.667  36.667  26.667  14.318  16.257  30.800  12.000
  164.            13.303  14.967  25.000  21.667  16.783  18.880    0.000  14.967
  165.         7.560    8.000  27.500  20.000  10.739  12.193  23.100    9.000
  166.         9.978  11.225  18.750  16.250  12.588  14.160    0.000  11.225
  167.  
  168.  
  169.  
  170.      ATI 18811-1 and ATI 18811-2 clock generators:
  171.  
  172.        Clocks 135.000  32.000 110.000  80.000 100.000 126.000  92.400  36.000
  173.            39.910  44.900  75.000  65.000  50.350  56.640    0.000  44.900
  174.            67.500  16.000  55.000  40.000  50.000  63.000  46.200  18.000
  175.            19.955  22.450  37.500  32.500  25.175  28.320    0.000  22.450
  176.            45.000  10.667  36.667  26.667  33.333  42.000  30.800  12.000
  177.            13.303  14.967  25.000  21.667  16.783  18.880    0.000  14.967
  178.            33.750    8.000  27.500  20.000  25.000  31.500  23.100    9.000
  179.         9.978  11.225  18.750  16.250  12.588  14.160    0.000  11.225
  180.  
  181.  
  182. Mach32 and Mach64 owners should only specify up to the first 32 frequencies.
  183.  
  184. The oldest Mach64 adapters use one of the clock generators described above.
  185. The possibilities for Mach64 adapters also include programmable clock genera-
  186. tors.  At bootup, video BIOS initialization programmes an initial set of fre-
  187. quencies.  Two of these are reserved to allow the setting of modes that do not
  188. use a frequency from this initial set.    One of these reserved slots is used by
  189. the BIOS mode set routine, the other by the particular driver used (MS-Windows,
  190. AutoCAD, X, etc.).  The clock numbers reserved in this way are dependent on the
  191. particular clock generator used on the adapter.
  192.  
  193. If the driver does not support the adapter's clock generator, it will try to
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ATI adapters README
  203.  
  204.  
  205.  
  206. match the clocks to one of the following specifications.  This matching will
  207. occur whether or not the user specifies the clocks in XF86Config.
  208.  
  209.      BIOS setting 1:
  210.  
  211.        Clocks    0.000 110.000 126.000 135.000  50.350  56.640  63.000  72.000
  212.         0.000  80.000  75.000  65.000  40.000  44.900  49.500  50.000
  213.         0.000  55.000  63.000  67.500  25.180  28.320  31.500  36.000
  214.         0.000  40.000  37.500  32.500  20.000  22.450  24.750  25.000
  215.  
  216.  
  217.  
  218.      BIOS setting 2:
  219.  
  220.        Clocks    0.000 110.000 126.000 135.000  25.180  28.320  31.500  36.000
  221.         0.000  80.000  75.000  65.000  40.000  44.900  49.500  50.000
  222.         0.000  55.000  63.000  67.500  12.590  14.160  15.750  18.000
  223.         0.000  40.000  37.500  32.500  20.000  22.450  24.750  25.000
  224.  
  225.  
  226.  
  227.      BIOS setting 3:
  228.  
  229.        Clocks    0.000    0.000    0.000    0.000  25.180  28.320    0.000    0.000
  230.         0.000    0.000    0.000    0.000    0.000    0.000    0.000    0.000
  231.         0.000    0.000    0.000    0.000  12.590  14.160    0.000    0.000
  232.         0.000    0.000    0.000    0.000    0.000    0.000    0.000    0.000
  233.  
  234.  
  235. If the driver matches the clocks to the third setting above, functionality will
  236. be *extremely* limited (assuming the driver works at all).
  237.  
  238. Other clock generators that have been used on ATI adapters (which can all be
  239. said to be clones of one of the above) might generate non-zero frequencies for
  240. those that are zero above, or vice-versa.
  241.  
  242. The order of the clocks *is* very important, although the driver will reorder
  243. the clocks if it deems it appropriate to do so.  Mach32 and Mach64 owners
  244. should note that this order is different than what they would use for the
  245. accelerated servers.
  246.  
  247. If the driver detects a supported programmable clock generator, it will ignore
  248. any XF86Config clock specification and programme the generator as needed by the
  249. modes to be used during the X session.
  250.  
  251. A clock probe, done with the command "X -probeonly", will help you decide which
  252. of the above to use for your particular adapter.  If the server consistently
  253. reports that it has detected an unknown clock generator, please e-mail me the
  254. stderr output.
  255.  
  256. Modes can be derived from the information in XFree86's doc directory.  If you
  257. do not specify a "modes" line in the display subsection of the appropriate
  258. screen section of your XF86Config, the driver will generate a default mode and
  259. attempt to use it.  The timings for the default mode are derived from the
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. ATI adapters README
  269.  
  270.  
  271.  
  272. timings of the mode (usually a text mode) in effect when the server is started.
  273.  
  274.  
  275. 5.  What is the history of the driver?
  276.  
  277. The complete history of the driver is rather cloudy.  The following is probably
  278. incomplete and inaccurate.
  279.  
  280. Apparently, Per Lindqvist (pgd@compuram.bbt.se) first got an ATI driver working
  281. with an early ATI card under X386 1.1a.  This original driver may have actually
  282. been based on an non-functional ATI driver written by Roell.  Then Doug Evans
  283. (dje@cygnus.com) ported the driver to the ATI VGA Wonder XL, trying in the pro-
  284. cess to make the driver work with all other ATI cards.
  285.  
  286. Rik Faith (faith@cs.unc.edu) obtained the X11R4 driver from Doug Evans in the
  287. summer of 1992, and ported the code to the X386 part of X11R5.    This subse-
  288. quently became part of XFree86.
  289.  
  290. I (Marc Aurele La France) took the driver over in the fall of 1993 after Rik
  291. got rid of his VGA Wonder card.
  292.  
  293.  
  294. 6.  Miscellaneous notes
  295.  
  296. In all cases, virtual resolutions must be less than 4096 pixels wide.  For VGA-
  297. Wonder V3 adapters with 256kB of video memory, and for all 264xT adapters, the
  298. 256-colour server will further limit virtual resolutions to less than 2048 pix-
  299. els wide.  These are hardware limits that cannot be circumvented.
  300.  
  301. Dot clocks greater than 80MHz cannot be used on most adapters as a way still
  302. needs to be discovered to make the VGA Wonder controller do pixel multiplexing.
  303.  
  304. Support for more than 8bpp colour depth is pending proper RAMDAC handling and
  305. banked framebuffer code for >8bpp.
  306.  
  307. Video memory corruption can still occur during mode switches on V3, V4 and V5
  308. adapters.  Symptoms of this problem include garbled fonts on return to text
  309. mode, and various effects (snow, dashed lines, etc) on initial entry into a
  310. graphics mode.    In the first case, the workaround is to use some other means of
  311. restoring the text font.  On Linux, this can be done with the kbd or svgalib
  312. packages.  In the second case, xrefresh will usually cleanup the image.
  313.  
  314. Video memory banking does not work in the 16-colour and monochrome servers on
  315. V3, V4 and V5 adapters (with 512kB of video memory).  This appears to be a
  316. hardware limitation.  The driver's default behaviour has been changed to take
  317. this into consideration by limiting video memory to 256kB.
  318.  
  319. Interlaced modes do not work in the monochrome server on 28800-x adapters when
  320. using a virtual resolution that is 2048 pixels or wider.  This appears to be a
  321. hardware limitation.  The driver has been changed to prune modes accordingly.
  322.  
  323. Support for virtual resolutions using more than 1MB of video memory is still
  324. incomplete.  Specifically, such support works on Mach32 adapters, and on 264xT
  325. adapters, but not on any other Mach64 adapters.  On 88800GX and 88800CX
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. ATI adapters README
  335.  
  336.  
  337.  
  338. adapters, this appears to be a hardware limitation.  Consequently, the driver's
  339. default behaviour is to limit video memory to 1MB.
  340.  
  341. There is some controversy over whether or not clocks higher than 135MHz should
  342. be allowed on 264xT adapters.  For now, clocks will be limited to 135MHz by
  343. default.  This limit can only be increased (up to a driver-calculated absolute
  344. maximum) through the DACSpeed option in XF86Config.  Be aware however that
  345. doing this is untested and might damage the adapter.
  346.  
  347. The default mode does not work on the more recent Mach64 adapters.  This will
  348. be fixed in a future release by reading the programmable clock generator's reg-
  349. isters.
  350.  
  351. Future development plans include addressing the above problems and using accel-
  352. erated functionality.
  353.  
  354. Please e-mail any bug reports, comments, etc. to Marc Aurele La France,
  355. tsi@ualberta.ca
  356.  
  357.      Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/ati.sgml,v 3.15.2.1 1997/06/01 12:33:36 dawes Exp $
  358.  
  359.  
  360.  
  361.  
  362.  
  363.      $XConsortium: ati.sgml /main/9 1996/10/19 18:03:54 kaleb $
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. ATI adapters README
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.                    CONTENTS
  471.  
  472.  
  473.  
  474. 1. What is the ATI VGA driver? .............................................. 1
  475.  
  476. 2. What is the ATI VGA driver *not*? ........................................ 1
  477.  
  478. 3. What video adapters will the driver work with? ........................... 2
  479.  
  480. 4. What should I put in my XF86Config file? ................................. 2
  481.  
  482. 5. What is the history of the driver? ....................................... 5
  483.  
  484. 6. Miscellaneous notes ...................................................... 5
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.                        i
  527.  
  528.  
  529.